home *** CD-ROM | disk | FTP | other *** search
/ CD Exchange / CD Exchange - Volume 1.iso / utils / misc / justlook / justlook.doc < prev    next >
Encoding:
Text File  |  1993-12-05  |  21.1 KB  |  664 lines
  1. TABLE OF CONTENTS
  2.  
  3. JustLook/ChooseMenu
  4. JustLook/Click
  5. JustLook/ClickGad
  6. JustLook/FindGad
  7. JustLook/FindScreen
  8. JustLook/FindWindow
  9. JustLook/GetRatio
  10. JustLook/GoOverGad
  11. JustLook/GoOverIcon
  12. JustLook/IEDisable
  13. JustLook/IEEnable
  14. JustLook/IEWait
  15. JustLook/InitSM
  16. JustLook/MoveMouse
  17. JustLook/RawType
  18. JustLook/Rel2Abs
  19. JustLook/SetDest
  20. JustLook/WinAct
  21. JustLook/WinDrag
  22. JustLook/WinResize
  23.  
  24.  
  25.  
  26.  
  27. JustLook/ChooseMenu                                       JustLook/ChooseMenu
  28.  
  29.    NAME
  30.        ChooseMenu - Selects a menu item.
  31.  
  32.    SYNOPSIS
  33.         ErrorCode ChooseMenu(struct ScrMap *SM,struct Window *Win,SHORT Menu, 
  34.                                                     SHORT MItem,SHORT SItem);
  35.  
  36.    FUNCTION
  37.         This one moves the mouse over a specified menu item and chooses 
  38.         it. Menu, MItem and SItem start with ZERO not one. the left most
  39.         menu is numbered 0, the next is numbered 1 and so on. For MItem
  40.         and SItem, 0 refers to the top option. The one below it is numbered 
  41.         1, and so on. Menu selection is done in the window pointed by  Win
  42.         and it should be the active one, other wise strange things happen.
  43.  
  44.         To suppress the pointer from going to a nonexistant menu item or 
  45.         subitem, pass a -1 in the corresponding place
  46.  
  47.    INPUTS
  48.         SM -- address af a ScrMap structure
  49.         Win -- pointer to the window containing the menu
  50.         Menu -- menu tilte number 
  51.         MItem -- menu item below the menu title
  52.         SItem -- submenu number
  53.  
  54.    RESULTS:
  55.         NO_ERROR: if every thing went OK.
  56.  
  57.         NO_SM: SM is NULL
  58.         BAD_ITEM: Menu should not be less than 0
  59.         NO_ITEM: specified menu title not found
  60.         NO_MENU: specified menu item not found
  61.         NO_SUB: specified submenu not found
  62.         Error codes returned by Click() and MoveMouse()
  63.  
  64.    SEE ALSO
  65.         Click(), MoveMouse()
  66.  
  67.  
  68. JustLook/Click                                                 JustLook/Click
  69.  
  70.    NAME
  71.        Click - clicks a mouse button.
  72.  
  73.    SYNOPSIS
  74.        ErrorCode Click(struct ScrMap *SM,WORD MouseButton,UWORD Qualifier,
  75.                                                                WORD UpDown);
  76.  
  77.    FUNCTION
  78.         Clicks mouse buttons at the place specified by SM, the buttons to
  79.         press are in MouseButton, an optional qualifier in Qualifier and
  80.         the action (press down, up or first down then up) in UpDown.
  81.  
  82.    INPUTS
  83.         SM -- addrees of a ScrMap structure
  84.         MouseButton -- the mouse button to act upon
  85.         Qualifier -- qualifier
  86.         UpDowd -- shows wether the action is a press, a release, or both
  87.  
  88.    RESULTS:
  89.         NO_ERROR: if every thing goes OK.
  90.         NO_BUTTON: Given button in 'MouseButton' does not exits!.
  91.         NO_ACT: Mask in UpDown is unknown.
  92.         NO_SM: SM is NULL
  93.         NO_DEVICE: could not open input device
  94.         NO_EXTIO: could not create ExtIO structure
  95.         NO_MEM: could not allocate memory
  96.         NO_PORT: could not create port
  97.  
  98.    SEE ALSO
  99.         InitSM()
  100.  
  101.  
  102. JustLook/ClickGad                                           JustLook/ClickGad
  103.  
  104.    NAME
  105.        ClickGad - moves the mouse over a gadget and clicks.
  106.  
  107.    SYNOPSIS
  108.        ErrorCode ClickGad(struct ScrMap *SM,struct Window *Win,char *GadName,
  109.                                                     USHORT GadID,SHORT Speed);
  110.  
  111.    FUNCTION
  112.         Calls GoOverGad() and then Click(). This is to shorten your
  113.         programs.
  114.  
  115.    INPUTS
  116.         SM -- addrees of a ScrMap structure
  117.         Win -- pointer to window containing the gadget
  118.         GadName -- pointer to gadget name
  119.         GadID -- gadget UserID value
  120.         Speed -- mouse movement speed
  121.  
  122.    RESULTS:
  123.         Error codes returned by GoOverGad() and Click()
  124.  
  125.    SEE ALSO
  126.         GoOverGad(), Click()
  127.  
  128.  
  129. JustLook/FindGad                                             JustLook/FindGad
  130.  
  131.    NAME
  132.        FindGad - finds the address of a gadget.
  133.  
  134.    SYNOPSIS
  135.        struct Gadget *FindGad(struct Window *Win,char *GadName,USHORT GadID);
  136.  
  137.    FUNCTION
  138.         Searches for the gadget with the name GadName in the window
  139.         pointed to by Win. if GadName is NULL, GadID is used in the search.
  140.         It is compared with the UserID field of the gadgets in the window 
  141.         and a pointer to the first one found is returned.
  142.  
  143.    INPUTS
  144.         Win -- pointer to the window containing the gadget
  145.         GadName -- pointer to the gadet name
  146.         GadID -- gadget UserID value
  147.  
  148.   RESULTS:
  149.       A pointer to the Gadget structure: if search successful.
  150.       NULL: if gadget not found.
  151.  
  152.    NOTES
  153.         GadName has priority over GadID, if GadName is not NULL, GadID
  154.         will not be used.
  155.  
  156.  
  157. JustLook/FindScreen                                       JustLook/FindScreen
  158.  
  159.    NAME
  160.        FindScreen - finds the address of a screen.
  161.  
  162.    SYNOPSIS
  163.        struct Screen *FindScreen(char *TitleToSearch);
  164.  
  165.    FUNCTION
  166.         Given the screen name, this routine searches the IntuitionBase
  167.         structure, and if found, returns a pointer to a Screen structure.
  168.         After finding, the routine continues searching and if another
  169.         Screen with the given name is found, a SCR_REPEATED is returned.
  170.         The program should act appropriately upon reciving this.
  171.  
  172.    INPUTS
  173.         TitleToSearch -- pointer to the screen name
  174.  
  175.    RESULTS
  176.         A pointer to a Screen structure: if search successful.
  177.         SCR_REPEATED: if two or more screens with the same name were found. 
  178.         NULL: if the screen is not found.
  179.  
  180.  
  181. JustLook/FindWindow                                       JustLook/FindWindow
  182.  
  183.    NAME
  184.        FindWindow - Finds the address of a window.
  185.  
  186.    SYNOPSIS
  187.        struct Window *FindWindow(char *TitleToSearch,
  188.                                              struct Screen *ScreenToSearch);
  189.    FUNCTION
  190.         This routines searches for a Window structure with a name in
  191.         TitleToSearch. if ScreenToSearch is NULL, all the screens in
  192.         IntuitionBase are inspected in turn, otherwise only the windows
  193.         in the specified screen are searched.
  194.  
  195.    INPUTS
  196.         TitleToSearch -- pointer to the window name
  197.         ScreenToSearch -- pointer to a Screen to start the search from 
  198.  
  199.    RESULTS
  200.         A pointer to a Window structure: if search successful 
  201.         WIN_REPEATED: if two or more windows with the same name were found
  202.         NULL: if the window was not found
  203.  
  204.  
  205. JustLook/GetRatio                                           JustLook/GetRatio
  206.  
  207.    NAME
  208.        GetRatio - finds the relation between screen and pointer resolutions.
  209.  
  210.    SYNOPSIS
  211.        ErrorCode GetRatio(struct ScrMap *SM,struct Screen *Scr);
  212.  
  213.    FUNCTION
  214.         This function is for internal use. The pupose of it is to find out
  215.         the relation between the screen resolution and pointer resolution.
  216.         The pointer is instructed to move 8 pixels, then the actual
  217.         movement is inspected and a ratio is found. The main use of this
  218.         ratio is in Click() routine. This routine is called from InitSM().
  219.  
  220.         With the scheme employed, it may be possible that the program 
  221.         encounters problems when the screen and pointer resolutions are not
  222.         dividable (for example, when instructed to go ahead 8 pixels, the
  223.         pointer actually advances 5 pixels).
  224.  
  225.    INPUTS
  226.        SM -- address of a ScrMap structure
  227.        Scr -- a pointer to a Screen Structure
  228.  
  229.    RESULTS:
  230.         NO_ERROR: if every thing goes OK.
  231.         NO_RATIO: GetRatio() failed
  232.         NO_DEVICE: could not open input device
  233.         NO_EXTIO: could not create ExtIO structure
  234.         NO_MEM: could not allocate memory   
  235.         NO_PORT: could not create message port
  236.  
  237.    NOTES
  238.         For the reasons described above, you should call InitSM(), each
  239.         time the screen resolution changes.
  240.  
  241.    SEE ALSO: ClicK(), InitSM().
  242.  
  243.  
  244. JustLook/GoOverGad                                         JustLook/GoOverGad
  245.  
  246.    NAME
  247.        GoOverGad - moves the mouse over a gadget.
  248.  
  249.    SYNOPSIS
  250.        ErrorCode GoOverGad(struct ScrMap *SM,struct Window *Win,char *GadName,
  251.                                                     USHORT GadID,SHORT Speed);
  252.  
  253.    FUNCTION
  254.         Finds the specified gadget with FindGad(), then moves the pinter
  255.         over it.
  256.  
  257.    INPUTS
  258.         SM -- address of a ScrMap structure
  259.         Win -- pointer to a window containing the gadget
  260.         GadName -- pointer to gadget name
  261.         GadID -- gadget UserID value
  262.  
  263.    RESULTS:
  264.         NO_SM: SM is NULL
  265.         NO_WIN: Win is NULL
  266.         Error codes returned by FindGad() and MoveMouse()
  267.  
  268.    SEE ALSO
  269.         FindGad(), MoveMouse()
  270.  
  271.  
  272. JustLook/GoOverIcon                                       JustLook/GoOverIcon
  273.  
  274.    NAME
  275.        GoOverIcon - moves the mouse pointer over an icon.
  276.  
  277.    SYNOPSIS
  278.        ErrorCode GoOverIcon(struct ScrMap *SM,struct Window *Win,UBYTE *Name);
  279.  
  280.    FUNCTION
  281.         A primitive attempt to provide icon clicking. The icon coordinates
  282.         are computed from the icon's structure on disk. and it should not
  283.         change its position on the screen, otherwise mouse poiter will
  284.         go wrong. This is because I did not find out how to get current
  285.         icon coordinates in the Workbench screen (Help!).
  286.  
  287.    INPUTS
  288.        SM -- address of a ScrMap structure
  289.        Win -- pointer to the window 
  290.        Name -- icon name
  291.  
  292.    RESULTS:
  293.        NO_SM: SM is NULL
  294.        NO_WIN: Win is NULL
  295.        Error codes returnd by MoveMouse().
  296.  
  297.    SEE ALSO MoveMouse()
  298.  
  299.  
  300. JustLook/IEDisable                                         JustLook/IEDisable
  301.  
  302.    NAME 
  303.        IEDiasable - disables mouse and/or keyboard.
  304.  
  305.    SYNOPSIS 
  306.         ErrorCode IEDisable(LONG Flag);
  307.  
  308.    FUNCTION
  309.         Disables input event for mouse or keyboard, according to the
  310.         mask in Flag. KBD for keyboard and MOUSE for mouse. In this case
  311.         no one can use mouse or keybaord. A Message port is set up each 
  312.         device disabled (mouse or keyboard). Their presence is always 
  313.         checked so only one program at a time can disable mouse or keyboard.
  314.  
  315.         Disabling is done by adding an input event handler at the priority
  316.         of 126, which nulls any event whose ie_SubClass is not 0xFF. Routines
  317.         in JustLook that generate input events, set ie_SubClass to 0xFF. The
  318.         handler code can be found in Hand.asm file.
  319.  
  320.    INPUTS
  321.        Flag -- specifies the device to disable
  322.  
  323.    RESULTS
  324.        NO_ERROR: every thing went OK
  325.        NO_ACT: flag should be KBD, MOUSE or KBD|MOUSE
  326.        PORT_FOUND: it seems that the device has already been disabled!
  327.        NO_PORT: could not create message port
  328.        NO_DEVICE: could not open input device
  329.        NO_EXTIO: could not create ExtIO structure
  330.        NO_MEM: could not allocate memory
  331.  
  332.    SEE ALSO
  333.         IEEnable()
  334.  
  335.  
  336. JustLook/IEEnable                                           JustLook/IEEnable
  337.  
  338.    NAME 
  339.        IEEnable - enables mouse and/or keyboard.
  340.  
  341.    SYNOPSIS
  342.         ErrorCode IEEnable(LONG  Flag);
  343.  
  344.    FUNCYION
  345.         Enables input event for mouse and keyboard after a previous call
  346.         to IEDisable(). The mask in Flag secifies what to enable: KBD for
  347.         keyboard or MOUSE for mouse. Enabling is done by removing the 
  348.         message ports created by IEDisable() and if both keyboard and mouse
  349.         are enabled, the handler routine which filtered input events is
  350.         also removed.
  351.  
  352.    INPUTS
  353.        Flag -- specifies the device to enable
  354.  
  355.    RESULTS
  356.        NO_ERROR: if every thing goes OK
  357.        NO_ACT: you passed something other than KBD or MOUSE to the routine
  358.        NO_STRUCT:
  359.        NO_PORT: could not create message port
  360.  
  361.    SEE ALSO 
  362.         IEDisable()
  363.  
  364.  
  365. JustLook/IEWait                                               JustLook/IEWait
  366.  
  367.    NAME
  368.        IEWait - waits for an input event. 
  369.  
  370.    SYNOPSIS
  371.         ErrorCode IEWait(LONG Flag);
  372.  
  373.    FUNCTION
  374.         Waits for an InputEvent. Returns an event even if the owner of
  375.         the event is someone else. You give a mask of what you want spied
  376.         in the Flag variable. Two possible values are KBD for Keyboard 
  377.         events and MOUSE for mouse events. Currently only MOUSE events are
  378.         supported. In ErrorCode you will get the result. A negative number 
  379.         is an error. otherwise it returns a code for the mouse button
  380.         pressed. 
  381.         This is done by adding a input event handler with a priority of
  382.         127. It waits for an event and signals the calling task, then the
  383.         handler is removed. Note that because this handler has priority
  384.         over IEDisable's one, it sends the signal before the event is 
  385.         nullified.
  386.  
  387.    INPUTS
  388.        Flag -- specifies which defice to wait for
  389.  
  390.    RESULTS
  391.        LBMASK: if left mouse button pressed
  392.        MBMAASK: if middle mouse button pressed
  393.        RBMASK: if right mouse button pressed
  394.        NO_ACT: if anything other than a MOUSE is given in Flag
  395.        NO_SIG: could not allocate signal
  396.        NO_DEVICE: could not open input device
  397.        NO_EXTIO: could not create ExtIO
  398.        NO_MEM: could not allocate memory
  399.        NO_PORT: could not create message port
  400.  
  401.    NOTES 
  402.         You can use this function even when mouse is disabled. Also,
  403.         remember that currently you can only wait on mouse events.
  404.  
  405.    SEE ALSO
  406.         IEDisable() 
  407.  
  408.  
  409. JustLook/InitSM                                               JustLook/InitSM
  410.  
  411.    NAME
  412.        InitSM - initializes a ScrMap structure.
  413.  
  414.    SYNOPSIS
  415.         ErrorCode InitSM(struct ScrMap *SM,struct Screen *Scr);
  416.  
  417.    FUNCTION
  418.         This function is used to initialize a SM structure. It is very
  419.         important to call this before using other JustLook routines.
  420.         Every ScrMap structure is tied to the Screen used to initialize it
  421.         so whenever screen resolution changes, use InitSM() on your SM
  422.         structure again!.
  423.  
  424.    INPUTS
  425.        SM -- address of a ScrMap structure to initialize
  426.        Scr -- pointer to a Screen to be used in initialization
  427.  
  428.    RESULTS
  429.         NO_ERROR: if every thing goes OK
  430.         NO_RATIO: GetRatio() failed
  431.         NO_DEVICE: could not open input device
  432.         NO_EXTIO: could not create ExtIO structure
  433.         NO_MEM: could not allocate memory
  434.         NO_PORT: could not create message port
  435.  
  436.    SEE ALSO
  437.         GetRatio()
  438.  
  439.  
  440. JustLook/MoveMouse                                         JustLook/MoveMouse
  441.  
  442.    NAME
  443.        MoveMouse - moves the mouse pointer.
  444.  
  445.    SYNOPSIS
  446.        ErrorCode MoveMouse(struct ScrMap *SM,BOOLEAN IsRelative,SHORT Speed);
  447.  
  448.    FUNCTION
  449.         Moves the mouse to the location specified in SM. If IsRelative
  450.         is ABSOLUTE, the DestX and DestY in SM are interpreted as the
  451.         absolute destination. if IsRelative is RELATIVE, destination in SM
  452.         is considered as relative to the current coordinate in SM.
  453.  
  454.         The routine does not end untill the pointer reaches the destination,
  455.         or it detects that the pointer is not moving.
  456.  
  457.         Even if for some problems the mouse pointer does not reach its 
  458.         destination, the program assumes it has, and further moves will be
  459.         thought as starting from there (in RELATIVE movements). 
  460.  
  461.    INPUTS
  462.        SM -- address of a ScrMap structure
  463.        IsRelative -- shows wether movement is relative or absolute
  464.        Speed -- speed of mouse movement
  465.  
  466.    RESULTS
  467.         NO_ERROR: if every thing goes OK
  468.         NO_MOVE: Pointer does not move! (maybe edge of screen?)
  469.         NO_DEVICE: could not open input device
  470.         NO_EXTIO: could not create ExtIO structure
  471.         NO_MEM: could not allocate memory
  472.         NO_PORT: could not create message port
  473.  
  474.    SEE ALSO
  475.         SetDest(),
  476.  
  477.  
  478. JustLook/RawType                                             JustLook/RawType
  479.  
  480.    NAME
  481.        RawType - generates raw key events.
  482.  
  483.    SYNOPSIS
  484.        ErrorCode RawType(struct RawInfo *RawKeys,ULONG Length,ULONG delay);
  485.  
  486.    FUNCTION
  487.         This is the only routines to handle keyboard. it sends raw key
  488.         events. The codes should be in a RawInfo structure. You place
  489.         the raw key number and also a qualifier (for example a SHIFT or
  490.         ALT key) in this structure. Length is the number of keys presses
  491.         to simulate. delay is passed to a DOS Delay() routine between each
  492.         key 'press'. This adjusts the speed of typing.
  493.  
  494.         The reason only raw events are generated is that I don't know how
  495.         to go from translated keys to raw keys (the opposite of what is 
  496.         usually done) in a way compatible with all Amiga keyboards and key
  497.         assignments (Help!), so I decided to put the burden on the shoulders
  498.         of the user!.  
  499.  
  500.    INPUTS
  501.        RawKeys -- pointer to an array of RayInfo structure
  502.        Length -- length of the above array
  503.        delay -- delay between key presses
  504.  
  505.    RESULTS
  506.        NO_ERROR: if every thing went OK
  507.        NO_KEY: if RawKeys in NULL
  508.        NO_DEVICE: could not open input device
  509.        NO_EXTIO: could not create ExtIO structure
  510.        NO_MEM: could not allocate memory
  511.        NO_PORT: could not create message port
  512.  
  513.  
  514. JustLook/Rel2Abs                                             JustLook/Rel2Abs
  515.  
  516.    NAME
  517.        Rel2Abs - converts relative coordinate to absolute.
  518.  
  519.    SYNOPSIS
  520.         VOID Rel2Abs(struct ScrMap *SM,SHORT *x, SHORT *y);
  521.  
  522.    FUNCTION
  523.         This procedure is for internal use. It converts the coordinates in
  524.         SM by adding the SHORT numbers pointed to by x and y to SM->CurrX
  525.         and SM->CurrY.
  526.  
  527.    INPUTS
  528.        SM -- address of a ScrMap structure to act upon
  529.        x -- pointer to relative movement in X direction
  530.        y -- pointer to a relative movement in Y direction
  531.  
  532.    RESULTS 
  533.        None
  534.  
  535.  
  536. JustLook/SetDest                                             JustLook/SetDest
  537.  
  538.    NAME
  539.        SetDest - sets destination for mouse movements.
  540.  
  541.    SYNOPSIS
  542.        VOID SetDest(struct ScrMap *SM,SHORT X,SHORT Y);
  543.  
  544.    FUNCTION
  545.         This is used to set the destination for MouseMove() routine. The
  546.         values in X and Y are copied to SM->DestX and SM->DestY respectively.
  547.         It is used to shorten both the amount of typing and program line
  548.         count in applications.
  549.  
  550.    INPUTS
  551.        SM -- address of a ScrMap structure
  552.        X -- destination in X direction
  553.        Y -- destination in Y direction
  554.  
  555.    RESULT
  556.        None
  557.  
  558.    SEE ALSO
  559.         MoveMouse()
  560.  
  561.  
  562. JustLook/WinAct                                               JustLook/WinAct
  563.  
  564.    NAME 
  565.        WinAct - performs the specified action on the screen.
  566.  
  567.    SYNOPSIS
  568.        ErrorCode WinAct(struct ScrMap *SM,struct Window *Win,LONG Act);
  569.  
  570.    FUNCTION
  571.         Clicks on either the close or the depth gadget of a window, acording 
  572.         to the value in Act. The actions are performed on a window 
  573.         pointed to by Win. 
  574.         The window is tested to see if close or depth gadgets are present,
  575.         if not so, a WIN_ACT error is returned, otherwise, mouse pointer
  576.         is moved to the place where the close or depth gadgets should be,
  577.         and a click is perforned
  578.  
  579.    INPUTS
  580.        SM -- address of a ScrMap structure
  581.        Win -- pointer to a Window to act upon
  582.        Act -- Action to perform
  583.  
  584.    RESULTS
  585.         NO_ERROR: if every thing goes OK
  586.         NO_SM: SM is NULL
  587.         NO_WIN: Win is NULL
  588.         NO_ACT: unknown action specified
  589.         Error codes returned by Click() and MoveMouse()
  590.  
  591.    SEE ALSO MouseMove(), Click()
  592.  
  593.  
  594. JustLook/WinDrag                                             JustLook/WinDrag
  595.  
  596.    NAME
  597.        WinDrag - drags the specified window.
  598.  
  599.    SYNOPSIS
  600.         ErrorCode WinDrag(struct ScrMap *SM,struct Window *Win,
  601.                                       BOOLEAN IsRelative, SHORT X, SHORT Y);
  602.  
  603.    FUNCTION
  604.         Drags the window pointed to by Win. If IsRelative is ABSOLUTE,
  605.         then the mouse pointer, after reaching the middle of the window,
  606.         goes to the absolute place specified by X and Y, other wise X and
  607.         Y are interpreted relative to the current coordinates in SM.
  608.        
  609.         I should emphasize that this is the mouse pointer that is moved
  610.         by the specified amount, this is done after placing the pointer
  611.         in the middle of the window drag bar.
  612.  
  613.    INPUTS
  614.        SM -- address of a ScrMap structure
  615.        Win -- pointer to a window to act upon
  616.        IsRelative -- shows wether dragging is relative or absolute
  617.        X -- drag 'X' pixels in the X direction
  618.        Y -- drag 'Y' pixels in the Y direction
  619.  
  620.    RESULTS
  621.         NO_ERROR: if every thing goes OK
  622.         NO_SM: SM is NULL
  623.         NO_WIN: Win is NULL
  624.         Error codes returned by Click() and MoveMouse()
  625.  
  626.    SEE ALSO
  627.         MoveMouse(), Click()
  628.  
  629.  
  630. JustLook/WinResize                                         JustLook/WinResize
  631.  
  632.  
  633.    NAME
  634.        WinResize - resizes a window.
  635.  
  636.    SYNOPSIS
  637.         ErrorCode WinResize(struct ScrMap *SM,struct Window *Win,
  638.                                         BOOLEAN IsRelative,SHORT X,SHORT Y);
  639.  
  640.    FUNCTION
  641.         Resizes the window pointed to by Win. If IsRelative is ABSOLUTE,
  642.         the resize gadget is draffed to that absolute point. Other wise a
  643.         relative move is made.
  644.  
  645.         This is done by placing the mouse over the size gadget and then
  646.         moving it by the specified amount.
  647.  
  648.    INPUTS
  649.        SM -- address of ScrMap structure
  650.        Win -- pointer to a window to act upon
  651.        IsRelative -- shows wethere resizing is relative or absolute
  652.        X -- resizes 'X' pixels in the X direction
  653.        Y -- resizes 'Y' pixels in the Y direction
  654.  
  655.    RESULTS
  656.         NO_SM: SM is NULL
  657.         NO_WIN: Win is NULL
  658.         NO_ACT: 
  659.         Errors codes returned by Click() and MoveMouse()
  660.  
  661.   SEE ALSO
  662.        MoveMouse(),Click()
  663.  
  664.